home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / mwind132.lzh / mauswind / mauswind.eng < prev    next >
Text File  |  1994-11-01  |  31KB  |  592 lines
  1.     Manual For Maus-Window V1.32 (as of 11/01/94)
  2.     ---------------------------------------------
  3.  
  4.  
  5.     1. Maus-Window?
  6.     ---------------
  7.  
  8.     People who have worked with X11 will have noticed that the active 
  9.     window is always the window located under the mouse-cursor (unless the 
  10.     window-manager has been configured otherwise). A similar behavior for 
  11.     ATARI-GEM would be nice, but unfortunately this can only be achieved by 
  12.     topping the window (or rewriting parts of the operating system). I 
  13.     found an article addressing this problem in a german magazine, but the 
  14.     methods described in there to automatically top a window all had 
  15.     serious disadvantages. So I decided to write a program to top windows 
  16.     myself, and the result is this accessory called Maus-Window. To install 
  17.     it, copy it to the root directory of the boot-drive. Maus-Window can 
  18.     also be used as a program, but this only makes sense in a multitasking-
  19.     environment. Maus-Window has no problems running under MultiTOS, 
  20.     MagiC, and Geneva, as an accessory or an application.
  21.  
  22.     When Maus-Window is active and the mouse-cursor resides over a non-
  23.     active window, the window will automatically be topped. This is 
  24.     achieved by simulating a mouse-click using the AES-call appl_tplay(). 
  25.     This confors to GEM and causes no problems with "clean" applications 
  26.     (see section 4 for a description of problematic programs).
  27.  
  28.     If the AES version number is >= 3.31, or if WINX >= 2.1 is installed, 
  29.     Maus-Window uses their extensions to find the owner of the affected 
  30.     window and then sends a WM_TOPPED-message to this application.
  31.  
  32.     When run under MultiTOS, Maus-Window additionally offers the 
  33.     possibility to raise the priority of the process with the topmost 
  34.     window. This allows more comfortable work.
  35.  
  36.     As of version 1.20, Maus-Window is bilingual, and thus has german and 
  37.     english dialogs. If the language of the computer running Maus-Window is 
  38.     not German, english dialogs will be used. If german dialogs are 
  39.     desired, install an _AKP-cookie (see: issue 4/93 German ST-Computer, 
  40.     Page 89) or (for MultiTOS users) set the AE_LANG environment variable. 
  41.     Falcon users can set the preferred language by using one of the NVRAM 
  42.     configuration utilities. This is the best method, since it will cause 
  43.     many other programs to show german text instead of english text as well.
  44.  
  45.  
  46.     2. Maus-Window Options
  47.     ----------------------
  48.  
  49.     When Maus-Window is activated (by selecting the entry in the desk-
  50.     menu), it shows a dialog in a window. In the parameter-box some options 
  51.     may be set (and later saved) which affect the behaviour of Maus-Window. 
  52.     Any changes made here will immediatly take effect. The "OK"-Buttons is 
  53.     only used for finally accepting the new settings (similar to XCONTROL-
  54.     modules). When Maus-Window is run as a program, you get this dialog by 
  55.     selecting the entry "Options: edit..." in the menu-bar.
  56.  
  57.     Maus-Window offers the following options:
  58.  
  59.     "Maus-Window active":
  60.     Tells Maus-Window whether it should top windows or not.
  61.  
  62.     "work-area only":
  63.     If this checkbox is crossed, windows will only be topped if the mouse-
  64.     cursor is located in the work-area of a window. With WINX < 2.1, this 
  65.     option must be selected (since not having done so might cause window 
  66.     gadgets to be operated instead of topping the window). This option is 
  67.     also useful for WINX >= 2.1 or MultiTOS, because then it's easier to 
  68.     operate the gadgets of background windows (otherwise, it may come to 
  69.     pass that the affected window is topped before).
  70.  
  71.     "prevent 'disappearing'":
  72.     Tells Maus-Window whether it should not top a window if it would 
  73.     completely cover the topmost window (or it's work-area, depeding on the 
  74.     setting of "work-area only").
  75.  
  76.     "don't top during mouse-movement":
  77.     If you do not want Maus-Window to top windows while the mouse is being 
  78.     moved, you should select this option.
  79.  
  80.     "delay: ..."
  81.     This option will cause Maus-Window to wait a certain amount of time 
  82.     until it tops a window (that means, the mouse-cursor must have been 
  83.     over the window for that time). The duration of the delay is measured 
  84.     in ds (10th parts of a second) and can be selected by using the up and 
  85.     down arrow (either the arrows in the dialog or the cursor-keys). Use 
  86.     double-clicks to increase/ decrease the value by ten.
  87.  
  88.     "wait for mouse-movement":
  89.     If this option is activated, Maus-Window will wait for a mouse-movement 
  90.     after the last change of the top-window. Example: Two windows are open, 
  91.     the mouse-cursor is in window #1, which is the topmost window. Now 
  92.     window #2 is topped through a keyboard action (like cycling windows). 
  93.     Without this option, Maus-Window will immediatly top window #1 again 
  94.     (which was obviously not the intention of the user). With this option 
  95.     active, Maus-Window will wait until the mouse is moved again, so window 
  96.     #2 will stay "on top". This option is also useful when using the 
  97.     backdrop-feature of MultiTOS or WINX. It is a good idea to also 
  98.     activate the option "don't top during mouse-movement".
  99.  
  100.     "protect windowless applications":
  101.     When working in a multitasking-environment, changing the active window 
  102.     may also mean changing the active application and the menu-bar. Since 
  103.     it is possible that an active application has no window open (then 
  104.     there is no active window), changing to another application by topping 
  105.     one if its windows causes the program without windows to be "lost". 
  106.     That means, it can't be reactivated by clicking on a window. If you 
  107.     don't want this, use this option. It causes Maus-Window to check if the 
  108.     active application has one or more windows open before topping one of 
  109.     another program. If the AES support it, Maus-Window will also check if 
  110.     the window which is going to be topped belongs to an accessory. In that 
  111.     case, that window will be activated even when the active application 
  112.     has no own windows, since accessories don't have menu-bars and thus 
  113.     activating a window of an accessory doesn't affect the active menu. It 
  114.     is not possible to check whether an application has an own menu-bar or 
  115.     not, so this extra-feature only affects accessories. "Protect 
  116.     windowless applications" is only available if the AES allow more than 
  117.     one application (multitasking) and support the extended menu_bar-call. 
  118.     The extra-feature (option doesn't affect windows of accessories) will 
  119.     be used if the AES have the appl_search-function. Both calls are 
  120.     supported by MultiTOS, MagiC and Geneva.
  121.  
  122.     "higher priority for top-window":
  123.     This option can only be used when running MultiTOS (Maus-Window also 
  124.     must have effective user ID 0, but this is only important for experts). 
  125.     If it is active, Maus-Window will automatically raise the priority of 
  126.     the process with the topmost window. The priority is reset to the old 
  127.     value if another process gets the top-window.
  128.  
  129.     "use mouse-click only":
  130.     As described in section 4, with KAOS and/or NVDI 1.x it may come to 
  131.     pass that the mouse-cursor jumps to the left border of the screen when 
  132.     Maus-Window tops a window. This options removes the problem by only 
  133.     simulating a mouse-click. Normally, the mouse-cursor is first 
  134.     postiioned in such a way that the simulated click really hits the 
  135.     correct window. It is a good idea to also select the option "don't top 
  136.     during mouse-movement", because otherwise it may come to pass that 
  137.     during fast mouse-movement the simulated click hits the wrong window. 
  138.     "Use mouse-click only" cannot be selected when working with WINX >= 2.1 
  139.     or AES >= 3.31, because in that case Maus-Window does not use a mouse-
  140.     click to top a window.
  141.  
  142.     Additionally, it is possible to decide which "special-keys" (shift 
  143.     left/right, control, and alternate) prevent Maus-Wi